A Rebar control acts as a container for child windows. It can contain one or more bands, and each band can have any combination of a gripper bar, a bitmap, a text label, and one child window. An application assigns a child window—typically another control— to a rebar control band. As you dynamically reposition a rebar control band, the rebar control manages the size and position of the child window assigned to that band. Also, an application can specify a background bitmap for a band, and the rebar control will display the band’s child window over the bitmap.
See: About Rebar Controls
Include file: CRebar.inc
| Name | Description |
|---|---|
| BeginDrag | Puts the rebar control in drag-and-drop mode. |
| DeleteBand | Deletes a band from a rebar control. |
| DragMove | Updates the drag position in the rebar control after a previous call to BeginDrag. |
| EndDrag | Terminates the rebar control’s drag-and-drop operation. |
| GetBandBorders | Retrieves the borders of a band. |
| GetBandCount | Retrieves the count of bands currently in the rebar control. |
| GetBandInfo | Retrieves information about a specified band in a rebar control. |
| GetBandMargins | Retrieves the margins of a band. |
| GetBarHeight | Retrieves the height of the rebar control. |
| GetBarInfo | Retrieves information about the rebar control and the image list it uses. |
| GetBkColor | Retrieves a rebar control’s default background color. |
| GetColorScheme | Retrieves the color scheme information from the rebar control. |
| GetDropTarget | Retrieves a rebar control’s IDropTarget interface pointer. |
| GetPalette | Retrieves the rebar control’s current palette. |
| GetRect | Retrieves the bounding rectangle for a given band in a rebar control. |
| GetRowCount | Retrieves the number of rows of bands in a rebar control. |
| GetRowHeight | Retrieves the height of a specified row in a rebar control. |
| GetTextColor | Retrieves a rebar control’s default text color. |
| GetTooltips | Retrieves the handle to any ToolTip control associated with the rebar control. |
| HitTest | Determines which portion of a rebar band is at a given point on the screen, if a rebar band exists at that point. |
| IdToIndex | Converts a band identifier to a band index in a rebar control. |
| InsertBand | Inserts a new band in a rebar control. |
| MaximizeBand | Resizes a band in a rebar control to either its ideal or largest size. |
| MinimizeBand | Resizes a band in a rebar control to its smallest size. |
| MoveBand | Moves a band from one index to another. |
| PushChevron | Sent to a rebar control to programmatically push a chevron. |
| RemoveDarkMode | Removes the rebar dark mode. |
| SetBandInfo | Sets characteristics of an existing band in a rebar control. |
| SetBandWidth | Sets the characteristics of a rebar control. |
| SetBarInfo | Sets the characteristics of a rebar control. |
| SetBkColor | Sets a rebar control’s default background color. |
| SetColorScheme | Sets the color scheme information for the rebar control. |
| SetDarkMode | Sets the rebar dark mode. |
| SetPalette | Sets the rebar control’s current palette. |
| SetParent | Sets a rebar control’s parent window. |
| SetTextColor | Sets a rebar control’s default text color. |
| SetTooltips | Associates a tooltip control with the rebar control. |
| SetWindowTheme | Sets the visual style of a rebar control. |
| ShowBand | Shows or hides a given band in a rebar control. |
| SizeToRect | Attempts to find the best layout of the bands for the given rectangle. |
Puts the rebar control in drag-and-drop mode.
SUB BeginDrag (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYVAL dwPos AS DWORD)| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Zero-based index of the band that the drag-and-drop operation will affect. |
| dwPos | DWORD value that contains the starting mouse coordinates. The horizontal coordinate is contained in the LOWORD and the vertical coordinate is contained in the HIWORD. If you pass (DWORD)-1, the rebar control will use the position of the mouse the last time the control’s thread called GetMessage or PeekMessage. |
The BeginDraw, DragMove, and EndDrag methods allow you to implement an IDropTarget interface for a rebar control. You call BeginDrag in response to IDropTarget.DragEnter, DragMove in response to IDropTarget.DragOver, and EndDrag in response to IDropTarget.Drop and IDropTarget.DragLeave.
Deletes a band from a rebar control.
FUNCTION DeleteBand (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD) AS BOOLEAN| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Zero-based index of the band to be deleted. |
Returns TRUE if successful, or FLASE otherwise.
Updates the drag position in the rebar control after a previous call to BeginDrag.
SUB DragMove (BYVAL hRebar AS HWND, BYVAL dwPos AS DWORD)| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| dwPos | DWORD value that contains the new mouse coordinates. The horizontal coordinate is contained in the LOWORD and the vertical coordinate is contained in the HIWORD. If you pass (DWORD)-1, the rebar control will use the position of the mouse the last time the control’s thread called GetMessage or PeekMessage. |
Terminates the rebar control’s drag-and-drop operation.
SUB EndDrag (BYVAL hRebar AS HWND)| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
Retrieves the borders of a band. The result of this message can be used to calculate the usable area in a band.
SUB GetBandBorders (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYVAL prc AS RECT PTR)
SUB GetBandBorders (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYREF rc AS RECT)
FUNCTION GetBandBorders (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD) AS RECT| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Zero-based index of the band for which the borders will be retrieved. |
| prc | Pointer to a RECT structure that will receive the band borders. If the rebar control has the RBS_BANDBORDERS style, each member of this structure will receive the number of pixels, on the corresponding side of the band, that constitute the border. If the rebar control does not have the RBS_BANDBORDERS style, only the left member of this structure receives valid information. |
Retrieves the count of bands currently in the rebar control.
FUNCTION GetBandCount (BYVAL hRebar AS HWND) AS DWORD| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
The number of bands assigned to the control.
Retrieves information about a specified band in a rebar control.
FUNCTION GetBandInfo (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYVAL prbbi AS REBARBANDINFOW PTR) AS BOOLEAN
FUNCTION GetBandInfo (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYREF rbbi AS REBARBANDINFOW) AS BOOLEAN
FUNCTION GetBandInfo (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD) AS REBARBANDINFOW| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Zero-based index of the band for which the information will be retrieved. |
| prbbi | Pointer to a REBARBANDINFO structure that will receive the requested band information. Before sending this message, you must set the cbSize member of this structure to the size of the REBARBANDINFO structure and set the fMask member to the items you want to retrieve. Additionally, you must set the cch member of the REBARBANDINFO structure to the size of the lpText buffer when RBBIM_TEXT is specified. |
Returns nonzero if successful, or zero otherwise.
Retrieves the margins of a band.
SUB GetBandMargins (BYVAL hRebar AS HWND, BYVAL pMargins AS MARGINS PTR)
SUB GetBandMargins (BYVAL hRebar AS HWND, BYREF _margins AS MARGINS)
FUNCTION GetBandMargins (BYVAL hRebar AS HWND) AS MARGINS| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| pMargins | Pointer to a MARGINS structure that receives the retrieved margins. |
Retrieves the height of the rebar control.
FUNCTION GetBarHeight (BYVAL hRebar AS HWND) AS DWORD| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
The height, in pixels, of the control.
Retrieves information about the rebar control and the image list it uses.
FUNCTION GetBarInfo (BYVAL hRebar AS HWND, BYVAL prbi AS REBARINFO PTR) AS BOOLEAN
FUNCTION GetBarInfo (BYVAL hRebar AS HWND, BYREF rbi AS REBARINFO) AS BOOLEAN
FUNCTION GetBarInfo (BYVAL hRebar AS HWND) AS REBARINFO| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| prbi | Pointer to a REBARINFO structure that will receive the rebar control information. You must set the cbSize member of this structure to sizeof(REBARINFO) before sending this message. |
Returns nonzero if successful, or zero otherwise.
Retrieves a rebar control’s default background color.
FUNCTION GetBkColor (BYVAL hRebar AS HWND) AS COLORREF| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
Returns a COLORREF value that represent the current default background color.
Retrieves the color scheme information from the rebar control.
FUNCTION GetColorScheme (BYVAL hRebar AS HWND, BYVAL pcs AS COLORSCHEME PTR) AS BOOLEAN
FUNCTION GetColorScheme (BYVAL hRebar AS HWND, BYREF cs AS COLORSCHEME) AS BOOLEAN
FUNCTION GetColorScheme (BYVAL hRebar AS HWND) AS COLORSCHEME| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| pcs | Pointer to a COLORSCHEME structure that will receive the color scheme information. You must set the dwSize member of this structure to sizeof(COLORSCHEME) before sending this message. |
Returns TRUE if successful, or FALSE otherwise.
Retrieves a rebar control’s IDropTarget interface pointer.
FUNCTION GetDropTarget (BYVAL hRebar AS HWND) AS IDropTarget PTR| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
Pointer to an IDropTarget interface. It is the caller’s responsibility to call Release on this pointer when it is no longer needed.
Retrieves the rebar control’s current palette.
FUNCTION GetPalette (BYVAL hRebar AS HWND) AS HPALETTE| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
Returns an HPALETTE that specifies the rebar control’s current palette.
Retrieves the bounding rectangle for a given band in a rebar control.
FUNCTION GetRect (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYVAL prc AS RECT PTR) AS BOOLEAN
FUNCTION GetRect (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYREF rc AS RECT) AS BOOLEAN
FUNCTION GetRect (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD) AS RECT| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Zero-based index of a band in the rebar control. |
| prc | Pointer to a RECT structure that will receive the bounds of the rebar band. |
Returns TRUE if successful, or FALSE otherwise.
Retrieves the number of rows of bands in a rebar control.
FUNCTION GetRect (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD) AS RECT| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
The number of band rows in the control.
Retrieves the height of a specified row in a rebar control.
FUNCTION GetRowHeight (BYVAL hRebar AS HWND, BYVAL uRow AS DWORD) AS DWORD| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uRow | Zero-based index of a band. The height of the row that contains the specified band will be retrieved. |
The row height, in pixels.
To retrieve the number of rows in a rebar control, use the GetRowCount method.
Retrieves a rebar control’s default text color.
FUNCTION GetTextColor (BYVAL hRebar AS HWND) AS COLORREF| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
Returns a COLORREF value that represent the current default text color.
Retrieves the handle to any tooltip control associated with the rebar control.
FUNCTION GetTooltips (BYVAL hRebar AS HWND) AS HWND| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
Returns the handle to the tooltip control associated with the rebar control, or zero if no tooltip control is associated with the rebar control.
Determines which portion of a rebar band is at a given point on the screen, if a rebar band exists at that point.
FUNCTION HitTest (BYVAL hRebar AS HWND, BYREF rhbt AS RBHITTESTINFO) AS LONG| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| rhbt | Pointer to an RBHITTESTINFO structure. Before sending the message, the pt member of this structure must be initialized to the point that will be hit tested, in client coordinates. |
Returns the zero-based index of the band at the given point, or -1 if no rebar band was at the point.
Converts a band identifier to a band index in a rebar control.
FUNCTION IdToIndex (BYVAL hRebar AS HWND, BYVAL uBandID AS DWORD) AS LONG| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBandID | The application-defined identifier of the band in question. This is the value that was passed in the wID member of the REBARBANDINFO structure when the band was inserted. |
Returns the zero-based band index if successful, or -1 otherwise. If duplicate band identifiers exist, the first one is returned.
Inserts a new band in a rebar control.
FUNCTION InsertBand (BYVAL hRebar AS HWND, BYVAL nIndex AS LONG, BYVAL prbbi AS REBARBANDINFOW PTR) AS BOOLEAN
FUNCTION InsertBand (BYVAL hRebar AS HWND, BYVAL nIndex AS LONG, BYREF rbbi AS REBARBANDINFOW) AS BOOLEAN| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| nIndex | Zero-based index of the location where the band will be inserted. If you set this parameter to -1, the control will add the new band at the last location. |
| prbbi | Pointer to a REBARBANDINFO structure that defines the band to be inserted. You must set the cbSize member of this structure to sizeof(REBARBANDINFO) before sending this message. |
Returns TRUE if successful, or FALSE otherwise.
Resizes a band in a rebar control to either its ideal or largest size.
SUB MaximizeBand (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYVAL fIdeal AS BOOLEAN)| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Zero-based index of the band to be maximized. |
| fIdeal | Indicates if the ideal width of the band should be used when the band is maximized. If this value is nonzero, the ideal width will be used. If this value is zero, the band will be made as large as possible. |
Resizes a band in a rebar control to its smallest size.
SUB MinimizeBand (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD)| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Zero-based index of the band to be minimized. |
Moves a band from one index to another.
FUNCTION MoveBand (BYVAL hRebar AS HWND, BYVAL nFrom AS DWORD, BYVAL nTo AS DWORD) AS BOOLEAN| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| nFrom | Zero-based index of the band to be moved. |
| nTo | Zero-based index of the new band position. |
Returns TRUE if successful, or FALSE otherwise.
This message will most likely change the index of other bands in the rebar control. If a band is moved from index 6 to index 0, all of the bands in between will have their index incremented by one.
nFrom must never be greater than the number of bands minus one. The number of bands can be obtained with the *GetBandCount** method.
Sent to a rebar control to programmatically push a chevron.
SUB PushChevron (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYVAL iAppValue AS DWORD)| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Zero-based index of the band whose chevron is to be pushed. |
| iAppValue | An application defined 32-bit value. It will be passed back to the application as the lParamNM member of the NMREBARCHEVRON structure that is passed with the RBN_CHEVRONPUSHED notification. |
Removes the rebar dark mode.
FUNCTION RemoveDarkMode(BYVAL hRebar AS HWND) AS HRESULT| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Sets characteristics of an existing band in a rebar control.
FUNCTION SetBandInfo (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYVAL prbbi AS REBARBANDINFOW PTR) AS BOOLEAN
FUNCTION SetBandInfo (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYREF rbbi AS REBARBANDINFOW) AS BOOLEAN| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Zero-based index of the band to receive the new settings. |
| prbbi | Pointer to a REBARBANDINFO structure that defines the band to be modified and the new settings. Before sending this message, you must set the cbSize member of this structure to the sizeof(REBARBANDINFO) structure. Additionally, you must set the cch member of the REBARBANDINFO structure to the size of the lpText buffer when RBBIM_TEXT is specified. |
Returns TRUE if successful, or FALSE otherwise.
Sets the width for a docked band.
FUNCTION SetBandWidth (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYVAL nWidth AS DWORD) AS BOOLEAN| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| uBand | Index of the band. |
| nWidth | New width in pixels. |
Returns TRUE if the value was set and FALSE otherwise.
Sets the characteristics of a rebar control.
FUNCTION SetBarInfo (BYVAL hRebar AS HWND, BYVAL prbi AS REBARINFO PTR) AS BOOLEAN
FUNCTION SetBarInfo (BYVAL hRebar AS HWND, BYREF rbi AS REBARINFO) AS BOOLEAN| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| prbi | Pointer to a REBARINFO structure that contains the information to be set. You must set the cbSize member of this structure to sizeof(REBARINFO) before sending this message. |
Returns TRUE if successful, or FALSE otherwise.
Sets a rebar control’s default background color.
FUNCTION SetBkColor (BYVAL hRebar AS HWND, BYVAL clrBk AS DWORD) AS DWORD| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| clrBk | COLORREF value that represents the new default background color. |
Returns a COLORREF value that represents the previous default background color.
The rebar control’s default background color is used to draw the background in a rebar control and all bands that are added after this message has been sent. The default background color for a particular band can be overridden when a band is added or modified by setting the RBBIM_COLORS flag in fMask and setting clrBack in the REBARBANDINFO structure.
When visual styles are enabled, this message has no effect.
Sets the color scheme information for the rebar control.
FUNCTION SetColorScheme (BYVAL hRebar AS HWND, BYVAL pcs AS COLORSCHEME PTR)
FUNCTION SetColorScheme (BYVAL hRebar AS HWND, BYREF cs AS COLORSCHEME)| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| pcs | Pointer to a COLORSCHEME structure that contains the color scheme information. |
The return value for this message is not used.
The rebar control uses the color scheme information when drawing the 3-D elements in the control and bands.
Sets the color scheme information for the rebar control.
FUNCTION SetDarkMode(BYVAL hRebar AS HWND) AS HRESULT| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Sets the rebar control’s current palette.
FUNCTION SetPalette (BYVAL hRebar AS HWND, BYVAL hPal AS HPALETTE) AS HPALETTE| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| hPal | An HPALETTE that specifies the new palette that the rebar control will use. |
Returns an HPALETTE that specifies the rebar control’s previous palette.
It is the responsibility of the application sending this message to delete the HPALETTE passed in this message (see DeleteObject). The rebar control will not delete an HPALETTE set with this message.
Sets a rebar control’s parent window.
FUNCTION SetParent (BYVAL hRebar AS HWND, BYVAL hwndParent AS hWND) AS HWND| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| hwndParent | Handle to the parent window to be set. |
Returns the handle to the previous parent window, or NULL if there is no previous parent.
The rebar control sends notification messages to the window you specify with this message. This message does not actually change the parent of the rebar control.
Sets a rebar control’s default text color.
FUNCTION SetTextColor (BYVAL hRebar AS HWND, BYVAL clrText AS COLORREF) AS COLORREF| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| clrText | COLORREF value that represents the new default text color. |
Returns a COLORREF value that represents the previous default text color.
The rebar control’s default text color is used to draw the text in a rebar control and all bands that are added after this message has been sent. The default text color for a particular band can be overridden when a band is added or modified by setting the RBBIM_COLORS flag in fMask and setting clrBack in the REBARBANDINFO structure.
Associates a tooltip control with the rebar control.
SUB SetTooltips (BYVAL hRebar AS HWND, BYVAL hwndToolTip AS HWND)| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| hwndToolTip | Handle to the tooltip control to be set. |
Associates a tooltip control with the rebar control.
SUB SetWindowTheme (BYVAL hRebar AS HWND, BYVAL pwszTheme AS WSTRING PTR)| Parameter | Description |
|---|---|
| hRebar | The handle of the Rebar control. |
| pwszTheme | Pointer to a Unicode string that contains the rebar visual style to set. |
Shows or hides a given band in a rebar control.
FUNCTION ShowBand (BYVAL hRebar AS HWND, BYVAL uBand AS DWORD, BYVAL fShow AS BOOLEAN) AS BOOLEAN| Parameter | Description |
|---|---|
| hRebar | Zero-based index of a band in the rebar control. |
| uBand | Handle to the tooltip control to be set. |
| fShow | Boolean value that indicates if the band should be shown or hidden. If this value is TRUE, the band will be shown. Otherwise, the band will be hidden. |
Returns TRUE if successful, or FALSE otherwise
Attempts to find the best layout of the bands for the given rectangle.
FUNCTION SizeToRect (BYVAL hRebar AS HWND, BYVAL prc AS RECT PTR) AS BOOLEAN
FUNCTION SizeToRect (BYVAL hRebar AS HWND, BYREF rc AS RECT) AS BOOLEAN
FUNCTION SizeToRect (BYVAL hRebar AS HWND) AS RECT| Parameter | Description |
|---|---|
| hRebar | Zero-based index of a band in the rebar control. |
| prc | Pointer to a RECT structure that specifies the rectangle to which the rebar control should be sized. |
Returns nonzero if a layout change occurred, or zero otherwise.
The rebar bands will be arranged and wrapped as necessary to fit the rectangle. Bands that have the RBBS_VARIABLEHEIGHT style will be resized as evenly as possible to fit the rectangle. The height of a horizontal rebar or the width of a vertical rebar may change, depending on the new layout.